home *** CD-ROM | disk | FTP | other *** search
Wrap
Text File | 2002-10-03 | 71.7 KB | 1,057 lines
XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) NNNNAAAAMMMMEEEE XXXXmmmmSSSSccccaaaalllleeee - The Scale widget class SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS #include <Xm/Scale.h> VVVVEEEERRRRSSSSIIIIOOOONNNN This page documents Motif 2.1. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN Scale is used by an application to indicate a value from within a range of values, and it allows the user to input or modify a value from the same range. A Scale has an elongated rectangular region similar to a ScrollBar. A slider inside this region indicates the current value along the Scale. The user can also modify the Scale's value by moving the slider within the rectangular region of the Scale. A Scale can also include a label set located outside the Scale region. These can indicate the relative value at various positions along the scale. The placement of this label depends on the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnnresource of the widget. A Scale can be either input/output or output only. An input/output Scale's value can be set by the application and also modified by the user with the slider. An output-only Scale is used strictly as an indicator of the current value of something and cannot be modified interactively by the user. The XXXXmmmmSSSSccccaaaalllleeee resource XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee specifies whether the user can interactively modify the Scale's value. The user can specify resources in a resource file for the automatically created gadget that contains the title of the Scale widget. The name of the gadget is TTTTiiiittttlllleeee. The placement of the title depends on the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnnresource of the widget. The direction of the title is based on the widget's layout direction. Scale uses the _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e trait, and holds the _X_m_Q_T_t_r_a_n_s_f_e_r trait. DDDDaaaattttaaaa TTTTrrrraaaannnnssssffffeeeerrrr BBBBeeeehhhhaaaavvvviiiioooorrrr Scale supports dragging of the representation of the Scale value from the Scale when the value is displayed and when the value of the XXXXmmmmNNNNeeeennnnaaaabbbblllleeeeUUUUnnnnsssseeeelllleeeeccccttttaaaabbbblllleeeeDDDDrrrraaaagggg resource of XXXXmmmmDDDDiiiissssppppllllaaaayyyy is set to True. As a source of data, Scale supports the following targets and associated conversions of data to these targets: _C_O_M_P_O_U_N_D__T_E_X_T Page 1 (printed 10/3/02) XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) The widget transfers a string representation of XXXXmmmmNNNNvvvvaaaalllluuuueeee as type _C_O_M_P_O_U_N_D__T_E_X_T. _S_T_R_I_N_G The widget transfers a string representation of XXXXmmmmNNNNvvvvaaaalllluuuueeee as type _S_T_R_I_N_G. ____MMMMOOOOTTTTIIIIFFFF____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS The widget transfers, as type _A_T_O_M, a list of the targets it supports for the _C_L_I_P_B_O_A_R_D selection. These include _S_T_R_I_N_G and _C_O_M_P_O_U_N_D__T_E_X_T. ____MMMMOOOOTTTTIIIIFFFF____EEEEXXXXPPPPOOOORRRRTTTT____TTTTAAAARRRRGGGGEEEETTTTSSSS The widget transfers, as type _A_T_O_M, a list of the targets to be used as the value of the DragContext's XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss in a drag-and-drop transfer. These include _S_T_R_I_N_G and _C_O_M_P_O_U_N_D__T_E_X_T. As a source of data, Scale also supports the following standard Motif targets: _B_A_C_K_G_R_O_U_N_D The widget transfers XXXXmmmmNNNNbbbbaaaacccckkkkggggrrrroooouuuunnnndddd as type _P_I_X_E_L. _C_L_A_S_S The widget finds the first shell in the widget hierarchy that has a WWWWMMMM____CCCCLLLLAAAASSSSSSSS property and transfers the contents as text in the current locale. _C_L_I_E_N_T__W_I_N_D_O_W The widget finds the first shell in the widget hierarchy and transfers its window as type _W_I_N_D_O_W. _C_O_L_O_R_M_A_P The widget transfers XXXXmmmmNNNNccccoooolllloooorrrrmmmmaaaapppp as type _C_O_L_O_R_M_A_P. _F_O_R_E_G_R_O_U_N_D The widget transfers XXXXmmmmNNNNffffoooorrrreeeeggggrrrroooouuuunnnndddd as type _P_I_X_E_L. _N_A_M_E The widget finds the first shell in the widget hierarchy that has a WWWWMMMM____NNNNAAAAMMMMEEEE property and transfers the contents as text in the current locale. _T_A_R_G_E_T_S The widget transfers, as type _A_T_O_M, a list of the targets it supports. These include the standard targets in this list. These also include _S_T_R_I_N_G and _C_O_M_P_O_U_N_D__T_E_X_T. _T_I_M_E_S_T_A_M_P The widget transfers the timestamp used to acquire the selection as type _I_N_T_E_G_E_R. ____MMMMOOOOTTTTIIIIFFFF____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE The widget transfers XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee if it exists, Page 2 (printed 10/3/02) XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) or else the default text render table, as type _S_T_R_I_N_G. ____MMMMOOOOTTTTIIIIFFFF____EEEENNNNCCCCOOOODDDDIIIINNNNGGGG____RRRREEEEGGGGIIIISSSSTTTTRRRRYYYY The widget transfers its encoding registry as type _S_T_R_I_N_G. The value is a list of NULL separated items in the form of tag encoding pairs. This target symbolizes the transfer target for the Motif Segment Encoding Registry. Widgets and applications can use this Registry to register text encoding formats for specified render table tags. Applications access this Registry by calling XXXXmmmmRRRReeeeggggiiiisssstttteeeerrrrSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg and XXXXmmmmMMMMaaaappppSSSSeeeeggggmmmmeeeennnnttttEEEEnnnnccccooooddddiiiinnnngggg. DDDDeeeesssscccceeeennnnddddaaaannnnttttssss Scale automatically creates the descendants shown in the following table. An application can use XXXXttttNNNNaaaammmmeeeeTTTTooooWWWWiiiiddddggggeeeetttt to gain access to the named descendant. In addition, a user or an application can use the named descendant when specifying resource values. NNNNaaaammmmeeeedddd DDDDeeeesssscccceeeennnnddddaaaannnntttt CCCCllllaaaassssssss IIIIddddeeeennnnttttiiiittttyyyy __________________________________________________________________________________________________ SSSSccccrrrroooollllllllbbbbaaaarrrr XXXXmmmmSSSSccccrrrroooollllllllBBBBaaaarrrr scroll bar TTTTiiiittttlllleeee XXXXmmmmLLLLaaaabbbbeeeellllGGGGaaaaddddggggeeeetttt title of scale CCCCllllaaaasssssssseeeessss Scale inherits behavior, resources, and traits from CCCCoooorrrreeee, CCCCoooommmmppppoooossssiiiitttteeee, CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt, and XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrrclasses. The class pointer is _x_m_S_c_a_l_e_W_i_d_g_e_t_C_l_a_s_s. The class name is XXXXmmmmSSSSccccaaaalllleeee. NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC prefix and use the remaining letters. To specify one of the defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmm prefix and use the remaining letters (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate if the given resource can be set at creation time (C), set by using XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is not applicable (N/A). XXXXmmmmSSSSccccaaaalllleeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt Page 3 (printed 10/3/02) XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNconvertCallback XmCCallback XtCallbackList NULL C XmNdecimalPoints XmCDecimalPoints short 0 CSG XmNdragCallback XmCCallback XtCallbackList NULL C XmNeditable XmCEditable Boolean True CSG XmNfontList XmCFontList XmFontList dynamic CSG XmNhighlightOnEnter XmCHighlightOnEnter Boolean False CSG XmNhighlightThickness XmCHighlightThickness Dimension 2 CSG XmNmaximum XmCMaximum int 100 CSG XmNminimum XmCMinimum int 0 CSG XmNorientation XmCOrientation unsigned char XmVERTICAL CSG XmNprocessingDirection XmCProcessingDirection unsigned char dynamic CSG XmNscaleHeight XmCScaleHeight Dimension 0 CSG XmNscaleMultiple XmCScaleMultiple int dynamic CSG XmNscaleWidth XmCScaleWidth Dimension 0 CSG XmNrenderTable XmCRenderTable XmRenderTable dynamic CSG XmNshowArrows XmCShowArrows XtEnum XmNONE CSG XmNshowValue XmCShowValue XtEnum XmNONE CSG XmNsliderMark XmCSliderMark XtEnum dynamic CSG XmNsliderVisual XmCSliderVisual XtEnum dynamic CSG XmNslidingMode XmCSlidingMode XtEnum XmSLIDER CSG XmNtitleString XmCTitleString XmString NULL CSG XmNvalue XmCValue int dynamic CSG XmNvalueChangedCallback XmCCallback XtCallbackList NULL C XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk Specifies a list of callbacks called when the Scale is asked to convert a selection. The type of the structure whose address is passed to these callbacks is XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason is XXXXmmmmCCCCRRRR____OOOOKKKK. XXXXmmmmNNNNddddeeeecccciiiimmmmaaaallllPPPPooooiiiinnnnttttssss Specifies the number of decimal points to shift the slider value when displaying it. For example, a slider value of 2,350 and an XXXXmmmmddddeeeecccciiiimmmmaaaallllPPPPooooiiiinnnnttttssssvalue of 2 results in a display value of 23.50. The value must not be negative. XXXXmmmmNNNNddddrrrraaaaggggCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callbacks that is called when the slider position changes as the slider is being dragged. The reason sent by the callback is XXXXmmmmCCCCRRRR____DDDDRRRRAAAAGGGG. XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee Specifies how the Scale scrollbar will react to user input. This resource can be True or False values, as follows: TTTTrrrruuuueeee Allows the scrollbar to be sensitive to user input. This is the default value. Page 4 (printed 10/3/02) XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) FFFFaaaallllsssseeee Makes the Scale scrollbar insensitive to user input. The visual is not greyed out. This value would mostly be used in XXXXmmmmTTTTHHHHEEEERRRRMMMMOOOOMMMMEEEETTTTEEEERRRRmode. When XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee is used on a widget it sets the dropsite to XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____AAAACCCCTTTTIIIIVVVVEEEE. XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt Specifies the font list to use for the title text string specified by XXXXmmmmNNNNttttiiiittttlllleeeeSSSSttttrrrriiiinnnngggg, and the label displayed when XXXXmmmmNNNNsssshhhhoooowwwwVVVVaaaalllluuuueeeeis True. The font list is an obsolete structure, and is retained only for compatibility with earlier releases of Motif. See the XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee resource. XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttOOOOnnnnEEEEnnnntttteeeerrrr Specifies whether the highlighting rectangle is drawn when the cursor moves into the widget. If the shell's focus policy is XXXXmmmmEEEEXXXXPPPPLLLLIIIICCCCIIIITTTT, this resource is ignored, and the widget is highlighted when it has the focus. If the shell's focus policy is XXXXmmmmPPPPOOOOIIIINNNNTTTTEEEERRRR and if this resource is True, the highlighting rectangle is drawn when the the cursor moves into the widget. If the shell's focus policy is XXXXmmmmPPPPOOOOIIIINNNNTTTTEEEERRRR and if this resource is False, the highlighting rectangle is not drawn when the the cursor moves into the widget. The default is False. XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttTTTThhhhiiiicccckkkknnnneeeessssssss Specifies the size of the slider's border drawing rectangle used for enter window and traversal highlight drawing. XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm Specifies the slider's maximum value. XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm must be greater than XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm. XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm Specifies the slider's minimum value. XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm must be greater than XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm. XXXXmmmmNNNNoooorrrriiiieeeennnnttttaaaattttiiiioooonnnn Displays Scale vertically or horizontally. This resource can have values of XXXXmmmmVVVVEEEERRRRTTTTIIIICCCCAAAALLLL and XXXXmmmmHHHHOOOORRRRIIIIZZZZOOOONNNNTTTTAAAALLLL. XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn Specifies whether the value for XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm is on the right or left side of XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm for horizontal Scales or above or below XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm for Page 5 (printed 10/3/02) XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) vertical Scales. This resource can have values of XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP,,,, XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM,,,, XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT, and XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT. If the Scale is oriented vertically, the default value is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP. If the XmScale is oriented horizontally, the default value depends on the XXXXmmmmNNNNllllaaaayyyyoooouuuuttttDDDDiiiirrrreeeeccccttttiiiioooonnnn resource of the widget. XXXXmmmmNNNNrrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeee Specifies the render table to use for the title text string specified by XXXXmmmmNNNNttttiiiittttlllleeeeSSSSttttrrrriiiinnnngggg, and the label displayed when XXXXmmmmNNNNsssshhhhoooowwwwVVVVaaaalllluuuueeee is True. If this value is NULL at initialization, the parent hierarchy is searched for an ancestor that holds the _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e trait. If such an ancestor is found, the render table is initialized to the XXXXmmmmLLLLAAAABBBBEEEELLLL____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE value of the ancestor widget. If no such ancestor is found, the default is implementation dependent. If a font list (XXXXmmmmNNNNffffoooonnnnttttLLLLiiiisssstttt) and a render table are both specified, the render table will take precedence. Refer to XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee(3) for more information on the creation and structure of a render table. XXXXmmmmNNNNssssccccaaaalllleeeeHHHHeeeeiiiigggghhhhtttt Specifies the height of the slider area. The value should be in the specified unit type (the default is pixels). If no value is specified a default height is computed. XXXXmmmmNNNNssssccccaaaalllleeeeMMMMuuuullllttttiiiipppplllleeee Specifies the amount to move the slider when the user takes an action that moves the slider by a multiple increment. The default is (XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm - XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm) divided by 10, with a minimum of 1. XXXXmmmmNNNNssssccccaaaalllleeeeWWWWiiiiddddtttthhhh Specifies the width of the slider area. The value should be in the specified unit type (the default is pixels). If no value is specified a default width is computed. XXXXmmmmNNNNsssshhhhoooowwwwAAAArrrrrrrroooowwwwssss Specifies whether the arrows are displayed and how they are to be displayed. This resource can take the following values: XXXXmmmmEEEEAAAACCCCHHHH____SSSSIIIIDDDDEEEE Indicates that one arrow is displayed on each end of the ScrollBar slider. XXXXmmmmMMMMAAAAXXXX____SSSSIIIIDDDDEEEE Page 6 (printed 10/3/02) XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) Indicates that one arrow is displayed on the XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm side of the ScrollBar slider. XXXXmmmmMMMMIIIINNNN____SSSSIIIIDDDDEEEE Indicates that one arrow is displayed on the XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm side of the ScrollBar slider. XXXXmmmmNNNNOOOONNNNEEEE Indicates that no arrows are displayed. XXXXmmmmNNNNOOOONNNNEEEE is the default value. XXXXmmmmNNNNsssshhhhoooowwwwVVVVaaaalllluuuueeee Specifies whether a label for the current slider value should be displayed next to the slider. If the value is XXXXmmmmNNNNEEEEAAAARRRR____SSSSLLLLIIIIDDDDEEEERRRR, the current slider value is displayed. If the value is XXXXmmmmNNNNOOOONNNNEEEE, no slider value is displayed. If the value is XXXXmmmmNNNNEEEEAAAARRRR____BBBBOOOORRRRDDDDEEEERRRR, the current slider value is displayed near the border. XXXXmmmmNNNNsssslllliiiiddddeeeerrrrMMMMaaaarrrrkkkk Specifies the shape the slider is to be displayed in. This resource can take the following values: XXXXmmmmEEEETTTTCCCCHHHHEEEEDDDD____LLLLIIIINNNNEEEE Specifies the slider as an etched line. This is the default when XXXXmmmmNNNNsssslllliiiiddddiiiinnnnggggMMMMooooddddeeee is XXXXmmmmSSSSLLLLIIIIDDDDEEEERRRR. XXXXmmmmNNNNOOOONNNNEEEE Specifies the slider as a foregrounded rectangle. This is the default when XXXXmmmmNNNNsssslllliiiiddddiiiinnnnggggMMMMooooddddeeee is XXXXmmmmTTTTHHHHEEEERRRRMMMMOOOOMMMMEEEETTTTEEEERRRR and the Scale scrollbar is insensitive to user input (XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee is FFFFaaaallllsssseeee. XXXXmmmmRRRROOOOUUUUNNNNDDDD____MMMMAAAARRRRKKKK Specifies the slider as a shadowed circle. This is the default when XXXXmmmmNNNNsssslllliiiiddddiiiinnnnggggMMMMooooddddeeee is XXXXmmmmTTTTHHHHEEEERRRRMMMMOOOOMMMMEEEETTTTEEEERRRR and the Scale scrollbar is sensitive to user input (XXXXmmmmNNNNeeeeddddiiiittttaaaabbbblllleeee is TTTTrrrruuuueeee. XXXXmmmmTTTTHHHHUUUUMMMMBBBB____MMMMAAAARRRRKKKK Specifies the slider as a series of three etched lines centered in the middle of the slider. XXXXmmmmNNNNsssslllliiiiddddiiiinnnnggggMMMMooooddddeeee Specifies the mode the slider works in. There are two possible modes: Page 7 (printed 10/3/02) XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) XXXXmmmmSSSSLLLLIIIIDDDDEEEERRRR Allows the slider to move freely between the minimum and maximum ends of the scale. This is the default value. XXXXmmmmTTTTHHHHEEEERRRRMMMMOOOOMMMMEEEETTTTEEEERRRR Forces the slider to be anchored to one side of the trough area. XXXXmmmmNNNNsssslllliiiiddddeeeerrrrVVVViiiissssuuuuaaaallll Specifies the color of the slider visual. This resource can take the following values: XXXXmmmmBBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD____CCCCOOOOLLLLOOOORRRR Specifies that the slider visual is in the background color. XXXXmmmmFFFFOOOORRRREEEEGGGGRRRROOOOUUUUNNNNDDDD____CCCCOOOOLLLLOOOORRRR Specifies that the slider visual is in the foreground color. XXXXmmmmSSSSHHHHAAAADDDDOOOOWWWWEEEEDDDD____BBBBAAAACCCCKKKKGGGGRRRROOOOUUUUNNNNDDDD Specifies that the slider visual is in the background color, with a shadow. This is the default when the _X_m_N_s_l_i_d_i_n_g_M_o_d_e_l resource is XXXXmmmmSSSSLLLLIIIIDDDDEEEERRRR. XXXXmmmmTTTTRRRROOOOUUUUGGGGHHHH____CCCCOOOOLLLLOOOORRRR Specifies that the slider visual is in the trough color. This is the default when the _X_m_N_s_l_i_d_i_n_g_M_o_d_e_l resource is XXXXmmmmTTTTHHHHEEEERRRRMMMMOOOOMMMMEEEETTTTEEEERRRR. XXXXmmmmNNNNttttiiiittttlllleeeeSSSSttttrrrriiiinnnngggg Specifies the title text string to appear in the Scale widget window. XXXXmmmmNNNNvvvvaaaalllluuuueeee Specifies the slider's current position along the scale, between XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm and XXXXmmmmNNNNmmmmaaaaxxxxiiiimmmmuuuummmm. The value is constrained to be within these inclusive bounds. The initial value of this resource is the larger of 0 (zero) and XXXXmmmmNNNNmmmmiiiinnnniiiimmmmuuuummmm. XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callbacks that is called when the value of the slider has changed. The reason sent by the callback is XXXXmmmmCCCCRRRR____VVVVAAAALLLLUUUUEEEE____CCCCHHHHAAAANNNNGGGGEEEEDDDD. IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss Scale inherits behavior and resources from the superclasses described in the following tables. For a complete description of each resource, refer to the reference page for that superclass. Page 8 (printed 10/3/02) XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNbottomShadowColor XmCBottomShadowColor Pixel dynamic CSG XmNbottomShadowPixmap XmCBottomShadowPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNforeground XmCForeground Pixel dynamic CSG XmNhelpCallback XmCCallback XtCallbackList NULL C XmNhighlightColor XmCHighlightColor Pixel dynamic CSG XmNhighlightPixmap XmCHighlightPixmap Pixmap dynamic CSG XmNinitialFocus XmCInitialFocus Widget NULL CSG XmNlayoutDirection XmCLayoutDirection XmDirection dynamic CG XmNnavigationType XmCNavigationType XmNavigationType XmTAB_GROUP CSG XmNpopupHandlerCallback XmCCallback XtCallbackList NULL C XmNshadowThickness XmCShadowThickness Dimension 2 CSG XmNstringDirection XmCStringDirection XmStringDirection dynamic CG XmNtopShadowColor XmCTopShadowColor Pixel dynamic CSG XmNtopShadowPixmap XmCTopShadowPixmap Pixmap dynamic CSG XmNtraversalOn XmCTraversalOn Boolean True CSG XmNunitType XmCUnitType unsigned char dynamic CSG XmNuserData XmCUserData XtPointer NULL CSG CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNchildren XmCReadOnly WidgetList NULL G XmNinsertPosition XmCInsertPosition XtOrderProc NULL CSG XmNnumChildren XmCReadOnly Cardinal 0 G CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss XmNaccelerators XmCAccelerators XtAccelerators dynamic CSG XmNancestorSensitive XmCSensitive Boolean dynamic G XmNbackground XmCBackground Pixel dynamic CSG XmNbackgroundPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderColor XmCBorderColor Pixel XtDefaultForeground CSG XmNborderPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderWidth XmCBorderWidth Dimension 0 CSG XmNcolormap XmCColormap Colormap dynamic CG XmNdepth XmCDepth int dynamic CG XmNdestroyCallback XmCCallback XtCallbackList NULL C XmNheight XmCHeight Dimension dynamic CSG XmNinitialResourcesPersistent XmCInitialResourcesPersistent Boolean True C XmNmappedWhenManaged XmCMappedWhenManaged Boolean True CSG XmNscreen XmCScreen Screen * dynamic CG XmNsensitive XmCSensitive Boolean True CSG XmNtranslations XmCTranslations XtTranslations dynamic CSG XmNwidth XmCWidth Dimension dynamic CSG XmNx XmCPosition Position 0 CSG XmNy XmCPosition Position 0 CSG CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn A pointer to the following structure is passed to the XXXXmmmmNNNNddddrrrraaaaggggCCCCaaaallllllllbbbbaaaacccckkkk and XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk procedures: Page 9 (printed 10/3/02) XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) typedef struct { int _r_e_a_s_o_n; XEvent * _e_v_e_n_t; int _v_a_l_u_e; } XmScaleCallbackStruct; _r_e_a_s_o_n Indicates why the callback was invoked _e_v_e_n_t Points to the _X_E_v_e_n_t that triggered the callback _v_a_l_u_e Is the new slider value A pointer to the following structure is passed to the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures: typedef struct { int _r_e_a_s_o_n; XEvent *_e_v_e_n_t; Atom _s_e_l_e_c_t_i_o_n; Atom _t_a_r_g_e_t; XtPointer _s_o_u_r_c_e__d_a_t_a; XtPointer _l_o_c_a_t_i_o_n__d_a_t_a; int _f_l_a_g_s; XtPointer _p_a_r_m; int _p_a_r_m__f_o_r_m_a_t; unsigned long _p_a_r_m__l_e_n_g_t_h; int _s_t_a_t_u_s; XtPointer _v_a_l_u_e; Atom _t_y_p_e; int _f_o_r_m_a_t; unsigned long _l_e_n_g_t_h; } XmConvertCallbackStruct; _r_e_a_s_o_n Indicates why the callback was invoked. _e_v_e_n_t Points to the _X_E_v_e_n_t that triggered the callback. It can be NULL. _s_e_l_e_c_t_i_o_n Indicates the selection for which conversion is being requested. Possible values are _C_L_I_P_B_O_A_R_D, _P_R_I_M_A_R_Y, _S_E_C_O_N_D_A_R_Y, and ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP. _t_a_r_g_e_t Indicates the conversion target. _s_o_u_r_c_e__d_a_t_a Contains information about the selection source. When the selection is ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP, _s_o_u_r_c_e__d_a_t_a is the DragContext. Otherwise, it is NULL. llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa Page 10 (printed 10/3/02) XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) Contains information about the location of data to be converted. If the value is NULL, the data to be transferred consists of the widget's current selection. _f_l_a_g_s Indicates the status of the conversion. Following are the possible values: XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____NNNNOOOONNNNEEEE This flag is currently unused. XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____PPPPAAAARRRRTTTTIIIIAAAALLLL The target widget was able to be converted, but some data was lost. XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____SSSSAAAAMMMMEEEE The conversion target is the source of the data to be transferred. XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTTIIIINNNNGGGG____TTTTRRRRAAAANNNNSSSSAAAACCCCTTTT This flag is currently unused. _p_a_r_m Contains parameter data for this target. If no parameter data exists, the value is NULL. When _s_e_l_e_c_t_i_o_n is _C_L_I_P_B_O_A_R_D and _t_a_r_g_e_t is ____MMMMOOOOTTTTIIIIFFFF____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS or ____MMMMOOOOTTTTIIIIFFFF____DDDDEEEEFFFFEEEERRRRRRRREEEEDDDD____CCCCLLLLIIIIPPPPBBBBOOOOAAAARRRRDDDD____TTTTAAAARRRRGGGGEEEETTTTSSSS, the value is the requested operation (XXXXmmmmCCCCOOOOPPPPYYYY, XXXXmmmmMMMMOOOOVVVVEEEE, or XXXXmmmmLLLLIIIINNNNKKKK). _p_a_r_m__f_o_r_m_a_t Specifies whether the data in _p_a_r_m should be viewed as a list of _c_h_a_r, _s_h_o_r_t, or _l_o_n_g quantities. Possible values are 0 (when _p_a_r_m is NULL), 8 (when the data in _p_a_r_m should be viewed as a list of _c_h_a_rs), 16 (when the data in _p_a_r_m should be viewed as a list of _s_h_o_r_ts), or 32 (when the data in _p_a_r_m should be viewed as a list of _l_o_n_gs). Note that _p_a_r_m__f_o_r_m_a_t symbolizes a data type, not the number of bits in each list element. For example, on some machines, a _p_a_r_m__f_o_r_m_a_t of 32 means that the data in _p_a_r_m should be viewed as a list of 64-bit quantities, not 32-bit quantities. _p_a_r_m__l_e_n_g_t_h Specifies the number of elements of data in _p_a_r_m, where each element has the size specified by _p_a_r_m__f_o_r_m_a_t. When _p_a_r_m is NULL, the value is 0. _s_t_a_t_u_s An IN/OUT member that specifies the status of the conversion. The initial value is Page 11 (printed 10/3/02) XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT. The callback procedure can set this member to one of the following values: XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT This value means that the widget class conversion procedure, if any, is called after the callback procedures return. If the widget class conversion procedure produces any data, it overwrites the data provided by the callback procedures in the _v_a_l_u_emember. XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____MMMMEEEERRRRGGGGEEEE This value means that the widget class conversion procedure, if any, is called after the callback procedures return. If the widget class conversion procedure produces any data, it appends its data to the data provided by the callback procedures in the _v_a_l_u_e member. This value is intended for use with targets that result in lists of data, such as _T_A_R_G_E_T_S. XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDOOOONNNNEEEE This value means that the callback procedure has successfully finished the conversion. The widget class conversion procedure, if any, is not called after the callback procedures return. XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____RRRREEEEFFFFUUUUSSSSEEEE This value means that the callback procedure has terminated the conversion process without completing the requested conversion. The widget class conversion procedure, if any, is not called after the callback procedures return. _v_a_l_u_e An IN/OUT parameter that contains any data that the callback procedure produces as a result of the conversion. The initial value is NULL. If the callback procedure sets this member, it must ensure that the _t_y_p_e, _f_o_r_m_a_t, and _l_e_n_g_t_h members correspond to the data in _v_a_l_u_e. The callback procedure is responsible for allocating, but not for freeing, memory when it sets this member. _t_y_p_e An IN/OUT parameter that indicates the type of the data in the _v_a_l_u_e member. The initial value is _I_N_T_E_G_E_R. Page 12 (printed 10/3/02) XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) _f_o_r_m_a_t An IN/OUT parameter that specifies whether the data in _v_a_l_u_e should be viewed as a list of _c_h_a_r, _s_h_o_r_t, or _l_o_n_g quantities. The initial value is 8. The callback procedure can set this member to 8 (for a list of _c_h_a_r), 16 (for a list of _s_h_o_r_t), or 32 (for a list of _l_o_n_g). _l_e_n_g_t_h An IN/OUT member that specifies the number of elements of data in _v_a_l_u_e, where each element has the size symbolized by _f_o_r_m_a_t. The initial value is 0. BBBBeeeehhhhaaaavvvviiiioooorrrr XmScale has the following behavior: <<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>> or <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>>: IIIInnnn tttthhhheeee rrrreeeeggggiiiioooonnnn bbbbeeeettttwwwweeeeeeeennnn aaaannnn eeeennnndddd ooooffff tttthhhheeee SSSSccccaaaalllleeee aaaannnndddd tttthhhheeee sssslllliiiiddddeeeerrrr: Moves the slider by one multiple increment in the direction of the end of the Scale and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT or XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward the right or bottom increments the Scale value, and movement toward the left or top decrements the Scale value. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT or XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement toward the right or bottom decrements the Scale value, and movement toward the left or top increments the Scale value. If the button is held down longer than a delay period, the slider is moved again by the same increment and the same callbacks are called. IIIInnnn sssslllliiiiddddeeeerrrr::::Activates the interactive dragging of the slider. <<<<BBBBttttnnnn2222DDDDoooowwwwnnnn>>>> in value label: Drags the contents of the label showing the current slider value. This action sets the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc of the DragContext to a function that calls the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures, possibly multiple times, for the ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP selection. <<<<BBBBttttnnnn1111MMMMoooottttiiiioooonnnn>>>> or <<<<BBBBttttnnnn2222MMMMoooottttiiiioooonnnn>>>>: If the button press occurs within the slider, the subsequent motion events move the slider to the position of the pointer and call the callbacks for XXXXmmmmNNNNddddrrrraaaaggggCCCCaaaallllllllbbbbaaaacccckkkk. <<<<BBBBttttnnnn1111UUUUpppp>>>> or <<<<BBBBttttnnnn2222UUUUpppp>>>>: If the button press occurs within the slider and the slider position is changed, the callbacks for Page 13 (printed 10/3/02) XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk are called. <<<<CCCCttttrrrrllll>>>><<<<BBBBttttnnnn1111DDDDoooowwwwnnnn>>>>: IIIInnnn tttthhhheeee rrrreeeeggggiiiioooonnnn bbbbeeeettttwwwweeeeeeeennnn aaaannnn eeeennnndddd ooooffff tttthhhheeee SSSSccccaaaalllleeee aaaannnndddd tttthhhheeee sssslllliiiiddddeeeerrrr: Moves the slider to that end of the Scale and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT or XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward the right or bottom increments the Scale value, and movement toward the left or top decrements the Scale value. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT or XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement toward the right or bottom decrements the Scale value, and movement toward the left or top increments the Scale value. <<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>>: For vertical Scales, moves the slider up one increment and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement toward the top increments the Scale value. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward the top decrements the Scale value. <<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>>: For vertical Scales, moves the slider down one increment and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward the bottom increments the Scale value. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement toward the bottom decrements the Scale value. <<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>>: For horizontal Scales, moves the slider one increment to the left and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT, movement toward the left increments the Scale value. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT, movement toward the left decrements the Scale value. <<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>>: For horizontal Scales, moves the slider one increment to the right and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT, movement toward the right increments the Scale value. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT, movement toward the right decrements the Scale value. <<<<CCCCttttrrrrllll>>>><<<<KKKKeeeeyyyy>>>><<<<oooossssffffUUUUpppp>>>> or <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeUUUUpppp>>>>: Page 14 (printed 10/3/02) XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) For vertical Scales, moves the slider up one multiple increment and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement toward the top increments the Scale value. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward the top decrements the Scale value. <<<<CCCCttttrrrrllll>>>><<<<KKKKeeeeyyyy>>>><<<<oooossssffffDDDDoooowwwwnnnn>>>> or <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeDDDDoooowwwwnnnn>>>>: For vertical Scales, moves the slider down one multiple increment and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____BBBBOOOOTTTTTTTTOOOOMMMM, movement toward the bottom increments the Scale value. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____TTTTOOOOPPPP, movement toward the bottom decrements the Scale value. <<<<CCCCttttrrrrllll>>>><<<<KKKKeeeeyyyy>>>><<<<oooossssffffLLLLeeeefffftttt>>>> or <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeLLLLeeeefffftttt>>>>: For horizontal Scales, moves the slider one multiple increment to the left and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT, movement toward the left increments the Scale value. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT, movement toward the left decrements the Scale value. <<<<CCCCttttrrrrllll>>>><<<<KKKKeeeeyyyy>>>><<<<oooossssffffRRRRiiiigggghhhhtttt>>>> or <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPaaaaggggeeeeRRRRiiiigggghhhhtttt>>>>: For horizontal Scales, moves the slider one multiple increment to the right and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____RRRRIIIIGGGGHHHHTTTT, movement toward the right increments the Scale value. If XXXXmmmmNNNNpppprrrroooocccceeeessssssssiiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmMMMMAAAAXXXX____OOOONNNN____LLLLEEEEFFFFTTTT, movement toward the right decrements the Scale value. <<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnLLLLiiiinnnneeee>>>> or <<<<KKKKeeeeyyyy>>>><<<<oooossssffffBBBBeeeeggggiiiinnnnDDDDaaaattttaaaa>>>>: Moves the slider to the minimum value and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks. <<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddLLLLiiiinnnneeee>>>> or <<<<KKKKeeeeyyyy>>>><<<<oooossssffffEEEEnnnnddddDDDDaaaattttaaaa>>>>: Moves the slider to the maximum value and calls the XXXXmmmmNNNNvvvvaaaalllluuuueeeeCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callbacks. <<<<KKKKeeeeyyyy>>>><<<<oooossssffffNNNNeeeexxxxttttFFFFiiiieeeelllldddd>>>>: Traverses to the first item in the next tab group. If the current tab group is the last entry in the tab group list, it wraps to the beginning of the tab group list. <<<<KKKKeeeeyyyy>>>><<<<oooossssffffPPPPrrrreeeevvvvFFFFiiiieeeelllldddd>>>>: Page 15 (printed 10/3/02) XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSccccaaaalllleeee((((3333XXXX)))) Traverses to the first item in the previous tab group. If the beginning of the tab group list is reached, it wraps to the end of the tab group list. <<<<KKKKeeeeyyyy>>>><<<<oooossssffffHHHHeeeellllpppp>>>>: Calls the callbacks for XXXXmmmmNNNNhhhheeeellllppppCCCCaaaallllllllbbbbaaaacccckkkk if any exist. If there are no help callbacks for this widget, this action calls the help callbacks for the nearest ancestor that has them. VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss The bindings for virtual keys are vendor specific. For information about bindings for virtual buttons and keys, see VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss(3). RRRREEEELLLLAAAATTTTEEEEDDDD CCCCoooommmmppppoooossssiiiitttteeee(3), CCCCoooonnnnssssttttrrrraaaaiiiinnnntttt(3), CCCCoooorrrreeee(3), XXXXmmmmCCCCrrrreeeeaaaatttteeeeSSSSccccaaaalllleeee(3), XXXXmmmmMMMMaaaannnnaaaaggggeeeerrrr(3), XXXXmmmmSSSSccccaaaalllleeeeGGGGeeeettttVVVVaaaalllluuuueeee(3), and XXXXmmmmSSSSccccaaaalllleeeeSSSSeeeettttVVVVaaaalllluuuueeee(3). Page 16 (printed 10/3/02)